package com.ruoyi.gateway.service;

import java.util.List;

import com.ruoyi.gateway.domain.DeviceMap;
import com.ruoyi.gateway.domain.TopicMap;
import com.ruoyi.gateway.domain.dto.TopicTransformResult;

/**
 * 主题映射Service接口
 *
 * @author 白向阳
 * @date 2025-09-28
 */
public interface ITopicMapService
{
    /**
     * 查询主题映射
     *
     * @param id 主题映射主键
     * @return 主题映射
     */
    public TopicMap selectTopicMapById(Long id);

    /**
     * 查询主题映射列表
     *
     * @param topicMap 主题映射
     * @return 主题映射集合
     */
    public List<TopicMap> selectTopicMapList(TopicMap topicMap);

    /**
     * 新增主题映射
     *
     * @param topicMap 主题映射
     * @return 结果
     */
    public int insertTopicMap(TopicMap topicMap);

    /**
     * 修改主题映射
     *
     * @param topicMap 主题映射
     * @return 结果
     */
    public int updateTopicMap(TopicMap topicMap);

    /**
     * 批量删除主题映射
     *
     * @param ids 需要删除的主题映射主键集合
     * @return 结果
     */
    public int deleteTopicMapByIds(Long[] ids);

    /**
     * 删除主题映射信息
     *
     * @param id 主题映射主键
     * @return 结果
     */
    public int deleteTopicMapById(Long id);

    /**
     * 设备主题转换为平台主题
     */
    TopicTransformResult transformDeviceToPlatform(String deviceTopic, DeviceMap deviceMapping);

    /**
     * 平台主题转换为设备主题
     */
    TopicTransformResult transformPlatformToDevice(String platformTopic, DeviceMap deviceMapping);

    /**
     * 刷新主题映射缓存
     */
    void refreshTopicCache();
}
